社媒情緒
介面描述
提供單個代幣的市場情緒指標資料，包括看漲、看跌、中立的观点比例和观点內容。
使用情境：
- 適用於對代幣的市場情緒綜合分析
- 適用於結合資金流向分析市場情緒與價格走勢的關係
- 適用於判斷市場多空情緒傾向
使用提示：
- 自然語言輸入市場情緒時可呼叫此介面，並同時呼叫即時資金資料介面來提供分析
資料更新頻率：每30分鐘更新一次
請求 URL
- 方法：
POST - 路徑：
/open/v1/social-sentiment/getCoinSocialSentiment
點數消耗
- 消耗點數：
2
前置條件
取得 vsTokenId
| 條件 | 說明 | 取得方式 |
|---|---|---|
| 已有 vsTokenId | 直接使用快取的 vsTokenId，無需重複查詢 | 上下文自動提取 |
| 未有 vsTokenId | 呼叫 POST /vs-token/list 介面取得 | 前置介面呼叫 |
請求參數
參數透過請求體（Body）以 JSON 格式傳遞。
| 參數名 | 類型 | 必需 | 描述 |
|---|---|---|---|
| vsTokenId | long | 是 | 代幣 ID |
回應欄位
僅展示 data 物件內的欄位結構：
| 欄位 | 類型 | 實際回傳類型 | 描述 |
|---|---|---|---|
| updateTime | long | long | 資料更新時間（毫秒時間戳） |
| vsTokenId | long | string | 代幣 ID |
| symbol | string | string | 代幣符號 |
| name | string | string | 代幣名稱 |
| bullishRatio | number | number | 看漲情緒比例 (0-1) |
| neutralRatio | number | number | 中性情緒比例 (0-1) |
| bearishRatio | number | number | 看跌情緒比例 (0-1) |
| bearishContents | array | array | 看跌總結內容列表 |
| english | string | string | 英文內容 |
| updateTime | long | long | 內容更新時間（毫秒時間戳） |
| neutralContents | array | array | 中性總結內容列表 |
| english | string | string | 英文內容 |
| updateTime | long | long | 內容更新時間（毫秒時間戳） |
| bullishContents | array | array | 看漲總結內容列表 |
| english | string | string | 英文內容 |
| updateTime | long | long | 內容更新時間（毫秒時間戳） |
欄位業務含義
以下欄位需要特別說明其業務含義：
| 欄位 | 業務含義 | 範圍/計算方式 | 使用建議 |
|---|---|---|---|
| bullishRatio | 看漲情緒比例 | 0-1，基於社媒內容情感分析 | 越接近 1 表示市場越看漲 |
| neutralRatio | 中性情緒比例 | 0-1，基於社媒內容情感分析 | 表示市場观望情緒占比 |
| bearishRatio | 看跌情緒比例 | 0-1，基於社媒內容情感分析 | 越接近 1 表示市場越看跌 |
| bullishContents | 看漲內容摘要 | 社媒內容的 AI 總結 | 了解市場看漲的具体原因 |
| bearishContents | 看跌內容摘要 | 社媒內容的 AI 總結 | 了解市場看跌的具体原因 |
請求範例
json
{
"vsTokenId": 1 // 代币关键字 (vsTokenId)
}cURL 範例（Linux/macOS）
bash
curl --location --request POST 'http://${host}/api/open/v1/social-sentiment/getCoinSocialSentiment' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
"vsTokenId": 1
}'cURL 範例（Windows CMD）
cmd
curl --location --request POST "http://${host}/api/open/v1/social-sentiment/getCoinSocialSentiment" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{ \"vsTokenId\": 1}"成功回應範例
json
{
"code": 200,
"message": "success",
"data": {
"updateTime": 1773315931000, // 数据更新时间
"vsTokenId": "1", // 代币关键字 (vsTokenId)
"symbol": "BTC", // 代币符号
"name": "Bitcoin", // 代币名称
"bullishRatio": 0.4113, // 看涨情绪比例
"neutralRatio": 0.4937, // 中性情绪比例
"bearishRatio": 0.095, // 看跌情绪比例
"bearishContents": [
{
"english": "$BTC faces conflicting narratives...", // 英文内容
"updateTime": 1773316047000 // 内容更新时间
},
{
"english": "$BTC faces intense bearish pressure...",
"updateTime": 1773314274000
},
{
"english": "Whales and treasury entities...",
"updateTime": 1773312461000
}
// ... 更多数据省略
],
"neutralContents": [
{
"english": "Whales and institutional actors...",
"updateTime": 1773316047000
},
{
"english": "$BTC remains central to macro speculation...",
"updateTime": 1773312461000
},
{
"english": "$BTC faces immediate resistance at $70K...",
"updateTime": 1773310591000
}
// ... 更多数据省略
],
"bullishContents": [
{
"english": "$BTC shows strong bullish conviction...",
"updateTime": 1773316047000
},
{
"english": "Whales are driving momentum...",
"updateTime": 1773314274000
},
{
"english": "Whales are reactivating long-dormant...",
"updateTime": 1773312461000
}
// ... 更多数据省略
]
},
"requestId": "xxx-xxx-xxx"
}